Namespaces
Variants

std::literals::string_literals::operator""s

Aus de.cppreference.net
 
 
 
std::basic_string
 
Definiert in Header <string>
std::string operator""s( const char* str, std::size_t len );
(1) (seit C++14)
(constexpr seit C++20)
constexpr std::u8string operator""s( const char8_t* str,
                                     std::size_t len );
(2) (seit C++20)
std::u16string operator""s( const char16_t* str, std::size_t len );
(3) (seit C++14)
(constexpr seit C++20)
std::u32string operator""s( const char32_t* str, std::size_t len );
(4) (seit C++14)
(constexpr seit C++20)
std::wstring operator""s( const wchar_t* str, std::size_t len );
(5) (seit C++14)
(constexpr seit C++20)

Erzeugt ein Zeichenkettenliteral des gewünschten Typs.

1) Gibt std::string{str, len} zurück.
2) Gibt std::u8string{str, len} zurück.
3) Gibt std::u16string{str, len} zurück.
4) Gibt std::u32string{str, len} zurück.
5) Gibt std::wstring{str, len} zurück.

Parameter

str - Zeiger auf den Anfang des rohen Zeichenarray-Literals
len - Länge des rohen Zeichenarray-Literals

Rückgabewert

Der String-Literal.

Hinweise

Diese Operatoren sind im Namensraum std :: literals :: string_literals deklariert, wobei sowohl literals als auch string_literals inline-Namespaces sind. Der Zugriff auf diese Operatoren kann mit einer der folgenden using -Direktiven erfolgen:

  • using namespace std :: literals
  • using namespace std :: string_literals
  • using namespace std :: literals :: string_literals

std::chrono::duration definiert ebenfalls operator""s zur Darstellung von Literal-Sekunden, handelt sich jedoch um einen arithmetischen Literal: 10.0s und 10s bedeuten zehn Sekunden, aber "10" s ist ein String.

Feature-Test Makro Wert Std Funktion
__cpp_lib_string_udls 201304L (C++14) Benutzerdefinierte Literale für String-Typen

Beispiel

#include <iostream>
#include <string>
void print_with_zeros(const auto note, const std::string& s)
{
    std::cout << note;
    for (const char c : s)
        c ? std::cout << c : std::cout << "₀";
    std::cout << " (size = " << s.size() << ")\n";
}
int main()
{
    using namespace std::string_literals;
    std::string s1 = "abc\0\0def";
    std::string s2 = "abc\0\0def"s;
    print_with_zeros("s1: ", s1);
    print_with_zeros("s2: ", s2);
    std::cout << "abcdef"s.substr(1,4) << '\n';
}

Ausgabe:

s1: abc (size = 3)
s2: abc₀₀def (size = 8)
bcde

Siehe auch

konstruiert einen basic_string
(öffentliche Elementfunktion)
erstellt einen String-View eines Zeichenarray-Literals
(Funktion)